GtkThemingEngine: Documents that engines must only use this API.

It was a bit unclear in the documentation, even if it was from the
API POV.

diff --git a/gtk/gtkthemingengine.c b/gtk/gtkthemingengine.c
index 886fc8f5ca7fc44b5a22ad2d414eccd4d8aa52a5..59cfcd3dd3e9759096136f8d11f912a539a57b88 100644 (file)
--- a/gtk/gtkthemingengine.c
+++ b/gtk/gtkthemingengine.c
@@ -45,6 +45,10 @@
  * must be created, alongside the CSS file that will reference it, the
  * theming engine would be created as an .so library, and installed in
  * $(gtk-modules-dir)/theming-engines/.
+ *
+ * #GtkThemingEngine<!-- -->s have limited access to the object they are
+ * rendering, the #GtkThemingEngine API has read-only accessors to the
+ * style information contained in the rendered object's #GtkStyleContext.
  */
 
 typedef struct GtkThemingEnginePrivate GtkThemingEnginePrivate;